Unzip v1.2 (Archive: FUNZIP12.ZIP) ================================== This is a freeware user-friendly shell (front-end) for the UNZIP.IMG image file from David Palmer. The UNZIP.IMG file can be found on CompuServe in the Palmtop forum library 18 in different versions (see the Installation section below) As with any freeware, I disclaim any liability whatsoever for problems created by this program. Although it works fine on my Psion 3a computers, I do not guarantee that this program is error free and I will not be held responsible for any damage or loss of any kind whatsoever. *** USE AT YOUR OWN RISK *** That said, I believe I have found all bugs and that Unzip is stable and reliable. I wrote this application as I could never remember the command line options I needed to unzip files. As David had kindly added full OPL launch support from version 1.4 of his UNZIP.IMG, I was inspired to create this very useful shell for David's unzip utility. Unzip can be used as a replacement for, or a supplement to David Palmer's RUN.APP. New Features in This Version (v1.2) =================================== * UNZIP.IMG v1.50 support only * Nice new icon * Directories used are remembered * Online-help * Create file list action * Selectable file types * Easier dialog * Uses much less run-time memory * Variant added for original series 3 users See the change history at then end of this file for exact change details. Archive Contents ================ When you unzipped this file you should have found: File Size Time Date UNZIP.TXT 16341 01:20 21-Jun-96 (this file) UNZIP.OPA 2937 01:20 21-Jun-96 (series 3a app) UNZIP.HLP 1689 01:20 21-Jun-96 (help file) UNZIP.CLS 2393 01:20 21-Jun-96 (series 3 app) Installation ============ NOTE: If you have a series 3 (not a 3a) then please read the Variants of UNZIP.OPA section towards the end of this file before proceding any further. 1. Make sure you have v1.50 of the UNZIP.IMG file. UNZIP.IMG is part of the complete unzip package from David Palmer, which is available as... Archive UNZIP.IMG Version S3UZ150L.ZIP v1.50l (preferred) S3UZ150S.ZIP v1.50s S3UNZIP.ZIP v1.50l & v1.50s File Version UNZIP.IMG v1.50l ...in the CompuServe Palmtop forum's library 18. You can also get UNZIP.IMG v1.50 by anonymous ftp from ftp://sunsite.doc.ic.ac.uk/computing/systems/ handhelds/psion/icdoc/utils/s3uzip15s.zip or s3uzip15l.zip For a detailed explanation of the difference between v1.50l and v1.50s, see the section "Variants of UNZIP.IMG" later on in this file. 2. Series 3 users only: Delete the supplied UNZIP.OPA (it is not required) and rename the file UNZIP.CLS to UNZIP.OPA 3. Copy UNZIP.OPA into the *same* directory as UNZIP.IMG To retain compatibility with RUN.APP, use a \RUN\ directory. If you do not have RUN.APP installed (or wish to remove it) then I recommend to copy the files including UNZIP.IMG to an \APP\UNZIP\ directory. NOTE: UNZIP.OPA will not work unless it is in the same directory and on the same disk as UNZIP.IMG. The file *must* be named UNZIP.OPA 4. Series 3a users only: If you wish to access online help for UNZIP.OPA, then copy UNZIP.HLP into the same directory as UNZIP.OPA. Online help is optional: if you already know how to unzip and wish to save memory space, you may omit the help file. 5. Install the UNZIP.OPA application from the system screen by using Psion-I, pressing Tab, and navigating to the directory where Unzip is located. NOTE: all you need to unzip is UNZIP.IMG and UNZIP.OPA. For the optional online help you also need UNZIP.HLP. All other files in David Palmer's archive can be deleted from the Psion if you need to save precious memory space. Operation ========= Unzip contains a simple dialog for selecting the usual unzip options. All options provided by UNZIP.IMG v1.50 are supported by the Unzip shell. When you start Unzip (the same way as you would start any other application) you will see a dialog that will look like this... Unzip v1.2 [Esc] to exit Unzip from file: Name Disk Internal Unzip to directory: Name \ Disk Internal Action: Extract files File types: All (*.*) Overwrite: Prompt Options: None NOTE: The example shows the series 3a variant, the series 3 variant looks slightly different. If you get any error messages on startup, see the section "Solving Problems" later on in this file. If you have UNZIP.IMG v1.50s then the dialog title will also show "(for PKZIP v2.x only)" indicating that only archives created with PKZIP version 2.0 and later can be unzipped (see "Variants of UNZIP.IMG" later on in this file). Pressing [Esc] from the dialog will exit Unzip and save the last used directories to an UNZIP.INI file. The UNZIP.INI file will be created on your default disk if it does not already exist. Press [Help] from the dialog to access the optional online Help. If you did not install the UNZIP.HLP file, then the author information will be displayed instead. Unzip's Dialog ============== Unzip from file --------------- Unzip displays files initially in the \ (root) directory on your default disk. Press [Tab] to bring up the file selector to select any file you wish. You can also access remote drives on your PC using either PsiWin or RCom - see the section "Accessing Remote Drives with Unzip" later on in this file. When Unzip exits, it saves the last used directory in the UNZIP.INI file. Unzip to directory ------------------ Unzip will initially unzip to \ on your default disk. Press [Tab] for the file selector to select any other directory. You can also unzip to remote drives on your PC using either PsiWin or RCom - see the section "Accessing Remote Drives with Unzip" later on in this file. When Unzip exits, it saves the last used directory in the UNZIP.INI file. Action ------ Extract files (default) This will extract all the zipped files in the archive. Update existing & create new This will unzip files only if the zipped files have a timestamp which is newer than the existing files in the destination directory (existing files will be overwritten), and it will also create any new files that do not exist. This is a good choice if you want to unzip an archive directly to a flash SSD. Unchanged files will *not* be overwritten, thus saving precious flash SSD space. Freshen (update existing only) This does the same as above except that *no* new files are created. This is the best choice if you wish to update an existing program but you do *not* want to unzip files that you do not have installed (eg: text files and optional files). A good choice when unzipping a newer program version directly to a flash SSD. NOTE: UNZIP.IMG complains if you choose this action together with the overwrite option "Never". Test archive integrity Test to see if the archive's files are not corrupted and if they can be unzipped OK by UNZIP.IMG . Display archive comment Does just that. NOTE: many archives do not use the comment feature however FUNZIP12.ZIP does! List files (short) Displays all the files in the archive showing just size, date, time and name. List files (long) This does the same as the short list but displays a bit more information about each file. Create file list (short) Creates a "\WRD\Filelist.wrd" file on your default disk containing the short file list. The file list is overwritten each time. This is very useful to see what files are in the archive, and as the file list is viewed in Word, gives a better display (especially when the archive contains many files) then the "List files" above. You can also print the file list from Word. Create file list (long) The same as above but with more information about each file. File types ---------- All (*.*), Readme (readme.*), Text (*.txt), Text (*.doc), Word (*.wrd), Agenda (*.agn), Data (*.dbf), Sound (*.wve), Sheet (*.spr), World (*.wld), Executable (*.app), Executable (*.opa), Executable (*.opo) You can select which files you wish to extract. This is handy if you just wish to extract just some files first (and maybe read them) before extracting the rest of the files. Only files that match the selected file type will be extracted. A match is made when: * the archived filename is stored in all lower or upper case (ie: readme.* or README.*) * the first letter of the matching text is upper case and the rest is lower case (ie: Readme.*, *.Txt, *,Dbf, etc.) You can check how the archived filenames are stored by creating a file list. Overwrite --------- NOTE: overwrite options do not apply to the "Create file list" action. Prompt Unzip will ask you what to do if it finds an existing file when extracting. Never Unzip will *never* overwrite any existing files. NOTE: UNZIP.IMG complains if you choose overwrite together with "Action: Freshen (update existing only)" Always Unzip will *always* overwrite existing files. Options ------- None No options. Discard paths If the archive contains paths, normally they are extracted and created when unzipping. Choosing this option will *prevent* the paths from being created, and all files will be unzipped to the same directory. Quiet operation Prevents some text from being displayed on the screen or saved to the file list. Very quiet operation Even quieter than quiet operation. Illegal Combinations ==================== UNZIP.IMG will complain if you select both "Action: Freshen (update existing only)" AND "Overwrite: Never" Variants of UNZIP.OPA ===================== The Unzip shell is enclosed in this archive in two variants: UNZIP.OPA (2937 bytes) Series 3a variant (v1.2) For the series 3a only, will not run on the series 3. Full utilisation of series 3a display size and help system. UNZIP.CLS (2401 bytes) Series 3 classic variant (v1.2c) Pruned-down variant for the series 3. Will run on the series 3a as well, but 3a users are encouraged to install the 3a variant. The classic variant is slightly different to the series 3a variant: * No help system possible (so do not install UNZIP.HLP) * Main dialog split into two sections and some dialog text shortened due to display space limitations If you need to install the series 3 classic variant, then rename the file UNZIP.CLS to UNZIP.OPA and install as shown above in the installation section. All of the unzip features are supported in the series 3 classic variant. Variants of UNZIP.IMG ===================== UNZIP.IMG v1.50 comes in two variants: v1.50l (large variant, 42160 bytes, *preferred*) Can extract files compressed with both PKZIP v1.x and PKZIP v2.x Install this variant if you have the space available (highly recommended) v1.50s (small variant, 32816 bytes) Can only extract files compressed with PKZIP v2.x. Attempting to extract files compressed with PKZIP v1.x will produce "unknown compression method" errors. Unzip knows if you have v1.50s by displaying the text "(for PKZIP v2.x only) in the dialog title. Install this variant if you are short on memory space and do not need to unzip PKZIP 1.x archives. UNZIP.IMG Compatibility ======================= This version of Unzip has been designed to work purely with v1.50s and v1.50l of UNZIP.IMG I have tested UNZIP.OPA with both versions of UNZIP.IMG... Version Size Time Date v1.50l 42160 01:50 13-Jun-96 v1.50s 32816 01:50 13-Jun-96 s = small, for PKZIP 2.x only l = large, for PKZIP 1.x and 2.x ...and both work happily. Older versions of UNZIP.OPA provide support for older UNZIP.IMG image files, see the change history below. Solving Problems ================ Error messages that show "Unzip" on the top of the screen and the Unzip icon are from the Unzip shell. Common error messages are: "Unzip.img not found" at startup means that the file UNZIP.IMG is not in the same directory on the same disk as UNZIP.OPA. Reinstall UNZIP.IMG v1.50 to the same place as UNZIP.OPA "Wrong Unzip.img" at startup means that your UNZIP.IMG file is not version v1.50. Install UNZIP.IMG v1.50 "Error in UNZIP\M Invalid name" or "Error in UNZIP\M End of file" at startup means that the UNZIP.INI file is corrupt. Delete UNZIP.INI (it is on your default disk) The INI file will be recreated automatically. "Error in UNZIP\M Write protected" after pressing [Enter] to continue from the dialog means that the UNZIP.INI file cannot be written as the default disk is write protected. Change the default disk from the system screen. "Error in UNZIP\M File or device in use" after pressing [Enter] to continue from the dialog means that the UNZIP.INI file cannot be written as it is being used by another program (maybe you are viewing it with Word?) Find the program using UNZIP.INI and exit it. Error messages that occur when "UnZip v5 for EPOC (version 1.50x)" is displayed are from the UNZIP.IMG file. Common error messages are: "can't allocate the work area" There is not enough free memory for the UNZIP.IMG file to run. Close other applications and delete unnecessary files to free up some disk memory. UNZIP.IMG needs about 100k free memory to run. "Cannot create [file]: write error or (disk full?)" UNZIP.IMG could not unzip any more files as the disk is most probably full. Close other applications and delete unnecessary files to free up some disk memory. "End-of-central-directory signature not found" The file you are trying to unzip is not a PKZIP compatible archive. Choose the correct file. "error: invalid response [x]" UNZIP.IMG was asking you to press a certain key and you pressed key [x] instead. Press a correct key. "unknown compression method" Archive was probably created with PKZIP v1.x and you are using UNZIP.IMG v1.50s. Install v1.50 variant l. Accessing Remote Drives with Unzip ================================== Accessing remote drives is possible with either PsiWin or RCom. MCLink has not been tested. Remote drives will always appear in the file selector prefixed with "REM::" NOTE: The default setting of PsiWin will not allow remote access of PC files from the Psion. You can change this by editing the PSIONPRC.INI file in the Windows directory, and removing the '-x' from the end of the line "engine=prcenwin.exe -x" Acknowledgements ================ Full and grateful acknowledgements go to David Palmer of Edinburgh, Scotland, for his wonderful UNZIP.IMG and his excellent documentation. Change History ============== 21-Jun-96 v1.2 Created series 3 classic variant (v1.2c). Reduced runtime memory requirements by 47%. File selector now shows all files (* instead of *.zip). Removed support for earlier versions of UNZIP.IMG to force the user to upgrade to v1.50 (s or l) and to reduce code size. Added better error handling when trying to find or detect the UNZIP.IMG file. Changed the icon. Unzip now remembers last directories used in UNZIP.INI. Added (optional) online help. Added ability to extract certain "File types". Added "Create file list" action. Rearranged the dialog layout and changed some dialog text. 07-May-96 v1.1 Added support for UNZIP.IMG v1.0/1.2/1.3. Renamed a couple of options and fixed a spelling mistake. Optimised code to make the .OPA as small as possible. 01-May-96 v1.0 Original version (only for UNZIP.IMG v1.41). ------------------- Jochen Siegenthaler Zurich, Switzerland 21 June, 1996 100127.3167@compuserve.com